SCPI Programming Examples

ARB Waveform in Single-Channel Configuration

ARB Waveform in Single-Channel Configuration with External Trigger

Bonded Configuration

ARB Waveform in Single-Channel Configuration

The SCPI programming example below can be used for loading and playing an ARB waveform in a single-channel configuration.

// Optional. Resets the system to its default state.

*RST

// Optional. Displays the instrument information.

*IDN?

// Optional. Check if any SCPI errors are in the Error Queue (if there are errors, continue to query until No Error is returned.

:SYST:ERR?

// Set the desired frequency.

:SOURce:RF1:FREQuency:CW 5.2GHz

// Set the desired power level.

:SOURce:RF1:POWer:AMPLitude 0

// Enable the RF Output.

:SOURce:RF1:OUTPut:STATe ON

// Select the waveform to play. This example uses a waveform provided in the Examples folder on the instrument. Copy the waveform

// you want to play onto the instrument using a network file transfer, a USB memory device, or via the MMEMory:DATA SCPI command. It is

// recommended you use the Waveforms folder which is the default folder for waveform operations.

:SOURce:GROup1:SIGNal1:WAVeform:SELect "..\Examples\5GNR_1CC_FR1_30kHz_SCS_100MHz_256QAM_DC Punctured.wfm"

// It is always good practice to query for errors after selecting the waveform to ensure the file correctly transferred to the signal generator's

// internal memory.

:SYST:ERR?

// Enable the waveform.

:SOURce:GROup1:SIGNal1:STATe ON

// For good measure check for errors here at the end of the SCPI example.

:SYST:ERR?

ARB Waveform in Single-Channel Configuration with External Trigger

The SCPI programming example below can be used for loading and playing an ARB waveform in a single-channel configuration, using an external trigger.

// Optional. Resets the system to its default state.

*RST

// Optional. Displays the instrument information.

*IDN?

// Optional. Check if any SCPI errors are in the Error Queue (if there are errors, continue to query until No Error is returned.

:SYST:ERR?

// Set the desired frequency.

:SOURce:RF1:FREQuency:CW 5.2GHz

// Set the desired power level.

:SOURce:RF1:POWer:AMPLitude 0

// Enable the RF Output.

:SOURce:RF1:OUTPut:STATe ON

// Select the waveform to play. This example uses a waveform provided in the Examples folder on the instrument. Copy the waveform

// you want to play onto the instrument using a network file transfer, a USB memory device, or via the MMEMory:DATA SCPI command. It is

// recommended you use the Waveforms folder which is the default folder for waveform operations.

:SOURce:GROup1:SIGNal1:WAVeform:SELect "..\Examples\5GNR_1CC_FR1_30kHz_SCS_100MHz_256QAM_DC Punctured.wfm"

// It is always good practice to query for errors after selecting the waveform to ensure the file correctly transferred to the signal generator's

// internal memory.

:SYST:ERR?

// Set the waveform trigger type to Continuous; meaning the waveform will play continuously when the trigger condition is met.

:SOURce:GROup1:SIGNal1:WAVeform:TRIGger:TYPE CONTinuous

// Set the trigger to external. The waveform will play when a TTL high level is detected on the External Trigger connector.

:SOURce:GROup1:SIGNal1:WAVeform:TRIGger:SOURce EXTernal

// Enable the waveform.

:SOURce:GROup1:SIGNal1:STATe ON

// For good measure check for errors here at the end of the SCPI example.

:SYST:ERR?

Bonded Configuration

The following SCPI sequence configures a bonded calibration using only the distortion calibration with no compaction, then performs the calibration, and determines the completion status. In this example, the ACP and power calibrations are disabled, as well as turning off compaction, for illustrative purposes only.

Notes:

  1. If a WFM file is utilized, some of the waveform properties may automatically be configured; however, it’s recommended to verify the waveform properties that the bonding calibration will utilize.

  2. The following example takes advantage of the default calculated values for many of the bonding calibration settings.

CONF CBON

CBON:WAVE "waveform file"

CBON:WAV:SCL:RATE <sample rate>

CBON:WAV:OBW <occupied bandwidth>

CBON:WAV:SCAL <scale>

CBON:FREQ <output frequency>

CBON:POW <output power>

GRO:SIGN:NCOR:INST:DIST ON

GRO:SIGN:NCOR:INST:ACP OFF

GRO:SIGN:NCOR:INST:POW OFF

GRO:SIGN:NCOR:INST:CLEV:MODE OFF

SYST:COMM:REM:ADDR <receiver address>

Switch VXG to the bonded configuration

Select a waveform file (can be any supported file type)

Setup the waveform properties (if needed)

 

 

Configure the output frequency and power

 

Enable distortion calibration (ON by default)

Turn off ACP and power calibration (or configure as desired)

 

If desired, turn off compaction (or setup as appropriate)

Set the VISA address of the receiver

Configure the timeout period for the VXG session, as a bonded calibration can take a significant period of time.

GRO:SIGN:NCOR:INST:RUN 

GRO:SIGN:NCOR:INST:RES?

SYST:ERR?

Start the bonded calibration

Query the success or failure of the calibration

Query for errors